home *** CD-ROM | disk | FTP | other *** search
/ InterCD 1999 June / june_1999.iso / Palm / Business / TC Logger / README < prev    next >
Encoding:
Text File  |  1999-03-09  |  5.0 KB  |  131 lines
  1. TCLogger version 0.2
  2.  
  3. Even though there are many time card logging programs out there, some
  4. that are pretty good, none of them completely filled my needs.  I
  5. decided to write my own time card logger.  The purpose is to accumulate
  6. time for a specific charge number or program throughout the day.  At the
  7. end of the day you copy data from TCLogger onto your timecard.
  8.  
  9. For changes to this version see "HISTORY" file.
  10.  
  11. FEATURES:
  12.  
  13.      - Has 7 timers for accumulating time.
  14.      - Switch back and forth between projects/charge numbers and get a
  15.        single accumulated time.
  16.      - Export data to the MemoPad.
  17.      - ToDo application is launched when ToDo hardbutton pushed.  This
  18.        allows TCLogger to be assigned to the ToDo hard button and you
  19.        can still easily launch ToDo application by pushing it a second
  20.        time.
  21.  
  22. NOTE:  The only major design decision I made was to not round data.
  23. When a timer is checked, it accumulates seconds.  The seconds are
  24. converted into selected display format.  The formats are hours and
  25. tenths of hours, hours and minutes, and seconds (not really useful
  26. except for testing).  The rounding design decision results in you don't
  27. see minutes incremented until a full 60 seconds is reached.  If the
  28. timer has been running for 59 seconds the display will be 0:00.
  29.  
  30. USAGE:
  31.  
  32. Just enter a description (optional) and check the checkbox next to it to
  33. start accumulating time.
  34.  
  35. TCLogger also has a "In" and "Out" button for recording in and out times
  36. for the day.
  37.  
  38. The "Update Timers"  button is used to update the timers to show the
  39. currently accumulated time.  I did not have the displays dynamically
  40. update since I did not want to possibly run down batteries by signing up
  41. for the "nil" event.  I heard/believe, but have no proof, that this
  42. could drain batteries.
  43.  
  44. Menus
  45.  
  46.      Export to MemoPad (/M) - This menu exports the data to the Unfiled
  47.      category of the MemoPad.  The first line contains the date the data
  48.      was exported.  Only timers with non-zero time are exported.
  49.  
  50.      All the Edit menus function like the ones you have seen before.
  51.  
  52.      Clear Focused - Clears the accumulated time for the timer that
  53.      currently has focus (insertion point on time or description of
  54.      timer.  The timer must be stopped to clear.
  55.  
  56.      Clear Stopped - Clears all stopped timers and clears the In and Out
  57.      times.
  58.  
  59.      Display - allows switching between display formats (H.H, H:M, Sec).
  60.  
  61. When editing the time accumulated, the timer must be stopped.  The time
  62. entered must have the format H.H, H:M, SEC.  Hit the "Update Timers"
  63. button to make sure the time was valid.  Edited time that is invalid
  64. will not be replaced and the previous time will be restored.  Starting a
  65. timer or hitting "Update Timers" will cause the program to check and
  66. validate time that has been edited.
  67.  
  68. If you want map TCLogger to the ToDo hardware button so you can bring it
  69. up quickly when changing charged projects/numbers.
  70.  
  71. I have been running TCLogger on my PalmPilot Professional with the 2MB
  72. upgrade for several weeks and have not had problems with it.  This does
  73. not mean it will work correctly for everyone, so please test it for
  74. awhile to make sure it works the way you expect.
  75.  
  76. INSTALLATION:
  77.  
  78. Just use your normal method of installing PalmOS applications to install
  79. the tclogger.prc file onto your Palm Connected organizer.  You do not
  80. have to remove any old versions prior to the install.  Always remember
  81. to backup before installing a new application.
  82.  
  83. FILES:
  84.  
  85.      README - this file
  86.      HISTORY - revision history file and wanted future additions.
  87.      tclogger.prc - TCLogger program
  88.      callback.h - Callback routine needed for GNU gcc compiled programs
  89.      tclogger.bmp - icon bitmap
  90.      tclogger.c - main program source code
  91.      tclogger.h - include file for defines of IDs
  92.      tclogger.rcp - resource file for prctools
  93.      tclogger.xpm - XPM version of icon
  94.      util.c - Utilities I try to reuse on other programs
  95.      util.h - include file for Utilities
  96.      util.rcp - resource file for Utilities
  97.      util_id.h - include file for defines of Utilties IDs
  98.      Makefile - makefile for use with tools listed below
  99.  
  100.  
  101. In order to give back some software, since I use a Linux/GNU system, I
  102. am distributing this application under the GNU General Public License
  103. (GPL).  See http://www.gnu.org/copyleft/gpl.html for a copy of the
  104. license.
  105.  
  106. I would like to thank all the programmers that provided tools that I
  107. used to develop this program.  Here is a list of the PalmOS development
  108. tools I used:
  109.  
  110.      pilot-xfer-0.9.0
  111.      gcc-2.7.2 cross compiler for Palm Connected Organizers
  112.      gdb-4.16
  113.      prctools-0.5.0
  114.      pilot-template-1.31
  115.      xcopilot-0.6.6
  116.  
  117. DISCLAIMER:
  118.  
  119. This software comes with NO warranty at all and I cannot be held
  120. responsible for anything it may do.  I take no responsibility for any
  121. problems that may arrise by using this program to log time.  Please
  122. fully check out the program to make sure it logs time as you expect.  I
  123. make no claims as to my ability to write programs.  You have the source
  124. code, so check it out. 
  125.  
  126.  
  127. Enjoy,
  128.  
  129. Kevin Dupree
  130. kdupree@flash.net
  131.